home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / util / sys / ReqCh.lha / ReqCh / ReqCh.doc < prev    next >
Text File  |  1997-07-31  |  2KB  |  57 lines
  1.  
  2. ****************************************************************************
  3.  
  4. REQUESTCHOICE a replacement written by: Joerg Riemer             [31-jul-97]
  5. -------------                           Schottmüllerstr.107
  6.                                         14167 Berlin Germany
  7.  
  8.                                  EMail: mission@cs.tu-berlin.de
  9.  
  10. ****************************************************************************
  11.  
  12. dear user
  13.  
  14. this command is a replacement for c:requestchoice, to be found in your
  15. directory since the os changes to V39. there are a couple of bugs in
  16. it which makes it unuseable. copy the new command over your old version
  17. and create some proper batchscript which use it to find out how great
  18. it can work.
  19.  
  20. ----------------------------------------------------------------------------
  21. to get a different to the original command the internal
  22. name was changed to [ReqCh] and the version was updated from 39.4 to 40.2
  23.  - because it needed 8'th sources to got a bug free version of ReqCh -
  24. ----------------------------------------------------------------------------
  25.  
  26. BUGS in the original requestchoice and why it won't work:
  27.  
  28. requestchoice uses the dos function (setioerr) to set the selected gadget
  29. number as the result2 variable, but it never returns. the reason for this
  30. is, the result2 variable depends on the returncode a program leaves in D0.
  31. a successful exit with a cleared returnregister signals the shell_process
  32. to clear the result2 variable also. that's why you never get a result2 value.
  33.  
  34. [it can be a bug or not. in that state it's a point of view]
  35.  
  36. in my opinion it's right to clear this variable also. because the result2
  37. variable is further to explain an improved error information and not for
  38. handling own used variable values.
  39.  
  40. to fix this, the new (requestchoice) will return the number of the
  41. selected gadget in a new local variable called "ReqChGG"
  42.  
  43. the result2 value will only be set if the program fails for other reasons.
  44.  
  45. ----------------------------------------------------------------------
  46. for example: look at the demo.script how to get the selected gadget id.
  47. ----------------------------------------------------------------------
  48.  
  49. other hidden bugs i removed:
  50.  
  51. it allocs memory about exec(allovec) - but don't frees them at the end
  52. the same occures for dos(readargs) - don't removed on exit
  53.  
  54. i hope so there is nothing more
  55.  
  56.    joerg...
  57.